游标类型（SQLSRV 驱动程序）

下载 PHP 驱动程序

通过 SQLSRV 驱动程序，可以创建能够以任何顺序访问且具有行的结果集，具体取决于游标类型。 本主题将讨论客户端（缓冲）和服务器端（非缓冲）游标。

使用 sqlsrv_query 或 sqlsrv_prepare 创建结果集时，可以指定游标的类型。 默认情况下使用只进游标，使用它可以从结果集的第一行开始一次移动一行，直到到达结果集的末尾。

可以使用可滚动游标创建结果集，这样可以采用任意顺序访问结果集中的任意行。 下表列出了可以传递给 sqlsrv_query 或 sqlsrv_prepare 中的 Scrollable 选项的值。

这是默认的游标类型。

sqlsrv_num_rows 返回使用此游标类型创建的结果集的错误。

forward 是 SQLSRV_CURSOR_FORWARD 的缩写形式。

static 是 SQLSRV_CURSOR_STATIC 的缩写形式。

sqlsrv_num_rows 返回使用此游标类型创建的结果集的错误。

dynamic 是 SQLSRV_CURSOR_DYNAMIC 的缩写形式。

keyset 是 SQLSRV_CURSOR_KEYSET 的缩写形式。

buffered 是 SQLSRV_CURSOR_CLIENT_BUFFERED 的缩写形式。

如果查询生成多个结果集，则 Scrollable 选项适用于所有结果集。

创建结果集后，可以使用 sqlsrv_fetch、sqlsrv_fetch_array 或 sqlsrv_fetch_object 来指定某一行。

下表介绍了可以在 row 参数中指定的值。

下面的示例显示了各种游标的效果。 在示例的第 33 行，你会看到指定不同游标的三个查询语句中的第一个。 其中有两个查询语句被注释掉。 每次运行该程序时，使用不同的游标类型来查看第 47 行上数据库更新的效果。

Microsoft Drivers for PHP for SQL Server 3.0 版本中添加了客户端游标功能，使用此功能可以在内存中缓存整个结果集。 使用客户端游标执行查询后，提供行计数。

客户端游标应用于中小型结果集。 对大型结果集使用服务器端游标。

如果缓冲区的大小不足以容纳整个结果集，查询将返回 false。 可以将缓冲区大小增加到 PHP 内存限制。

使用 SQLSRV 驱动程序，可以使用 sqlsrv_configure 的 ClientBufferMaxKBSize 设置来配置用于保存结果集的缓冲区大小。 sqlsrv_get_config 返回 ClientBufferMaxKBSize 的值。 还可以使用 sqlsrv.ClientBufferMaxKBSize 在 php.ini 文件中设置最大缓冲区大小（例如，sqlsrv.ClientBufferMaxKBSize = 1024）。

以下示例显示：

使用客户端游标时，始终提供行计数。

使用客户端游标和批处理语句。

下面的示例演示了使用 sqlsrv_prepare 和不同客户端缓冲区大小的客户端游标。

指定游标类型和选择行